home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 013a / pagr10.zip / PAGER10.DOC < prev   
Text File  |  1991-12-04  |  4KB  |  102 lines
  1. Program:        Pager
  2. Version:        1.0
  3. Date:           December 4, 1991
  4. Author:         George Spafford
  5.  
  6. Purpose:
  7.  
  8. To paginate DOS text files that lack appropriate form feed characters
  9. (ASCII 12).   The reformatted text should be able to be ported either to
  10. a file or the printer.
  11.  
  12. Procedure:
  13.  
  14. PAGER may be invoked with all arguments on the command line or they may be
  15. entered interactively in the program.  Let's cover the command line first:
  16.  
  17. PAGER /S:source.fil /T:target.fil /P:nnnn
  18.  
  19.       /S:source.fil     This is the text file that needs to be paginated.
  20.   
  21.       /T:target.fil     This is where the paginated info will go.
  22.                         This can be a device name.  I have used PRN regularly
  23.                         to send information to the printer.  This is handy for
  24.                         a "quick copy" to a 60 line laser printer.
  25.  
  26.       /P:nnnn           "nnnn" is the number of lines per page.  This number
  27.                         can not exceed 32,767 lines. (I kind of doubted that
  28.                         this many would every be necessary so I just used an
  29.                         integer to hold the value.)
  30.  
  31.       /D                This toggles double spacing on.  It can only be
  32.                         activated on the command line.  So, even if you
  33.                         intend on entering the file names and number of lines
  34.                         per page manually, you must still invoke the program
  35.                         with the /D switch (pager /d).
  36.  
  37. Note:  All command line options are used only during program execution, they
  38.        are not stored.  If you are going to repeatedly use a setting, then
  39.        perhaps you should set up a batch file.  For a 60 line Laser Printer,
  40.        you could pass the file name that you want to print with an environment
  41.        variable.  Assuming that PAGER is in the PATH, let's look at LJ.BAT:
  42.  
  43.        PAGER /S:%1 /T:PRN /P:60
  44.  
  45.        One line that's all you need!  Just invoke it as:
  46.  
  47.        LJ myfile.txt
  48.  
  49.  
  50.  
  51. If you do not use the command line, the program will prompt you for the above
  52. listed information, the source file, output file and the number of lines per
  53. page.  It will not prompt you for double spacing.  You must specify it on the
  54. command line using the /D switch before the program is run.
  55.  
  56. While the program is running, the input file, output file and percent completed
  57. will be listed.  When all of the source file has been read and exported, a tally
  58. of the total number of lines will be displayed.
  59.  
  60. When the program is placing the form feeds, it will not place one on the first
  61. page so you must manually position the paper according to the number of lines
  62. that you want on each page.  Also, the program WILL place a form feed at the
  63. end of the export file (or advance a page on the printer) to take the paper up
  64. to the beginning of the next form.
  65.  
  66. For files that already have form feeds that you wish to get rid of, look for
  67. DEPAGER on a BBS (my board, EXEC-PC, etc.) it will remove all incidences of
  68. the ASCII 12 Form Feed character at a very respectable speed (Thanks to
  69. Borland C++).
  70.  
  71.    
  72. Register:
  73.  
  74.      I hope this program helps you evaluate some of your problems
  75.      or even makes some solutions/benefits clear.  This program is
  76.      released as shareware.  Its price is $5 for each concurrently
  77.      used copy.  If you have any suggestions or comments, I'd REALLY
  78.      like to hear those too.
  79.  
  80.             Sincerely,
  81.  
  82.             George Spafford
  83.             3001 LakeShore Drive, #329
  84.             St. Joseph, MI 49085
  85.  
  86.      Data:  (616) 468-5026  Queued Access BBS 14.4Kb USR Dual HST
  87.                             FIDOnet: 1:2340/0 NEC/NC Sysop:  Tim Akright
  88.  
  89. Legal stuff:
  90.  
  91. PAGER IS DISTRIBUTED AS IS.  THE AUTHOR (GEORGE SPAFFORD) MAKES NO
  92. WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED
  93. TO WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE,
  94. WITH RESPECT TO THIS SOFTWARE AND DOCUMENTATION. IN NO EVENT SHALL
  95. THE AUTHOR BE LIABLE FOR ANY DAMAGES, INCLUDING LOST PROFITS, LOST
  96. SAVINGS, OR ANY OTHER INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
  97. OUT OF THE USE OF OR THE INABILITY TO USE THIS PROGRAM.
  98. ----------------------------------------------------------------------------
  99.  
  100.  
  101.  
  102.